dxp-ux

(0 reviews)

GET logicalResourcebyId (TMF639)

1.This is implemented for PA Market.

2.This is to retrieve the customer subscription profile by passing IMSI number as input.

URL

http://[localhost]:[port]/dxp-ux/v1/{businessId}/logicalResource/{id}

URL PARAMS

nametypedescriptionrequired
businessIdstring2 letter ISO 3166 country code (PA) identifying the business unit.Y
idstringIdentifier of the Resource.
Expected Pattern/length for IMSI value:
Minimum Number of digits: 14
Maximum Number of Digits: 15
Y

Query PARAMS

nametypedescriptionrequired
@typestringType of logical resource.
Possible Value : IMSI
Y

Headers

nametypedescriptionrequired
client_idstringThe client_id identifying the channel.Y
client_secretstringPassword associated with the client_id.Y
X-Correlation-IDstringIdentifier that correlates HTTP request between a client and server. Any identification model (UUDI, checksum, etc.) can be used, as long as it is a unique value to differentiate a transaction.Y for Business

Data Model - Response

field nametypedescriptionrequired (mandatory-Y, optional-N, Not applicable- N/A)
idstringIdentifier of an instance of the resource. Required to be unique within the resource type. Used in URIs as the identifier for specific instances of a type.Y
hrefstringThe URI for the object itself.N
namestringA string used to give a name to the resource.Y
resourceStatusstringA resource status type. Tracks the resource status of the resource,
Possible Values: standby, active, alarm, available, reserved, suspended, unknown.
Y
resourceCharacteristic[]ArrayA list of characteristics. Describes a given characteristic of an object or entity through a name/value pair.Y
resourceCharacteristic[].namestringName of the characteristicY
resourceCharacteristic[].valueanyValue of the characteristicY
resourceRelationship[]ArrayA list of resource relationshipsY
resourceRelationship[].relationshipTypestringType of the resource relationshipY
resourceRelationship[].resourceobjectA resource to be created defined by value or existing defined by reference.Y
resourceRelationship[].resource.idstringIdentifier of an instance of the resource. Required to be unique within the resource type. Used in URIs as the identifier for specific instances of a type.Y
resourceRelationship[].resource.namestringA string used to give a name to the resourceY
@typestringWhen sub-classing, this defines the sub-class Extensible nameY
resourceCharacteristic subResource - dataModel
resource characteristic nametypedescriptionrequired(mandatory-Y, optional-N, Not applicable- N/A)examples
pin1stringThis is PIN1 valueN{
"name": "pin1",
"value": "1111"
}
pin2stringThis is PIN2 valueN{
"name": "pin2",
"value": "6021"
}
puk1stringThis is PUK1 valueN{
"name": "puk1",
"value": "78617534"
}
puk2stringThis is PUK2 valueN{
"name": "puk2",
"value": "12962790"
}
prepaidIndstringIs to show the service Prepaid or not(Y or N)Y{
"name": "prepaidInd",
"value": "N"
}
sim-providstringThis is SIM-PROVID valueN{
"name": "sim-provid",
"value": "05.06"
}
serviceCategorystringThis is service category value.N{
"name": "serviceCategory",
"value": "Black List"
}
resourceRelationship subResource - dataModel
resourceRelationship nametypedescriptionrequired(mandatory-Y, optional-N, Not applicable- N/A)examples
MSISDNstringService NumberY{
"relationshipType": "reliesOn",
"resource": {
"id": "66770996",
"name": "MSISDN"
}
}
SIMstringSubscriber Identity ModuleN{
"relationshipType": "reliesOn",
"resource": {
"id": "89507010000023865393",
"name": "SIM"
}
}

Key considerations

Please find the response in the following link - GET LogicalResourceById - DXP-UX

  • This is implemented for prepaid and postpaid mobile customers.
  • Value for @type Query Parameter should be "IMSI", when input ID is IMSI number.
  • Prepaid/Postpaid subscriber can be identified using resourceCharacteristic.value (Y=Prepaid, N=Postpaid) when resourceCharacteristic.name is prepaidInd.
  • Possible values of resourceCharacteristic.value when resourceCharacteristic.name is serviceCategory : Black List, White List, Prepaid, Postpaid B2C, Postpaid B2B.

Reviews